

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>The Tagged Values Window [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Tagged Value,Tagged Value View,Tagged Value Duplicate Values,Tagged Value Modify,Tagged Value Window,Tagged Value Toolbar,Tagged Value Model Components And,Tagged Value Fully-Qualified Value,Tagged Value What Is A?,Window,Window Tagged Value,What Is,What Is A Tagged Value">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">The Tagged Values Window</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="notetab.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="assigningdefinedtaggedvalue.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_SubHeadingL1"><span class="f_SubHeadingL1">What is a Tagged Value?</span></p>
<p class="p_BodyText"><span class="f_BodyText">A </span><span class="f_BodyText" style="font-style: italic;">Tagged Value</span><span class="f_BodyText">, strictly, is the </span><span class="f_BodyText" style="font-style: italic;">value</span><span class="f_BodyText"> of a property of a modeling <a href="thetaggedvaluestab.htm#ModelFeatures">item</a>, the property being called a </span><span class="f_BodyText" style="font-style: italic;">tag</span><span class="f_BodyText">. For example, a Class element called </span><span class="f_BodyText" style="font-style: italic;">Person</span><span class="f_BodyText"> might have a tag called </span><span class="f_BodyText" style="font-weight: bold;">Age</span><span class="f_BodyText"> with the Tagged Value of </span><span class="f_BodyText" style="font-weight: bold;">42</span><span class="f_BodyText">. More loosely, the combination of tag and value can be referred to as a Tagged Value.</span></p>
<p class="p_BodyText"><span class="f_BodyText">A </span><span class="f_BodyText" style="font-style: italic;"><a href="propertytypes.htm">Tagged Value Type</a></span><span class="f_BodyText"> is a group of parameters that define and/or limit the possible values of a tag and, in many instances, how a specific value is assigned to the tag. For example, the tag </span><span class="f_BodyText" style="font-weight: bold;">Age</span><span class="f_BodyText"> might have a Tagged Value Type of </span><span class="f_BodyText" style="font-weight: bold;">Integer</span><span class="f_BodyText">, so the user simply types in a numeric value. Alternatively, the type could be </span><span class="f_BodyText" style="font-weight: bold;">Spin</span><span class="f_BodyText">, with lower and upper limits of, say, </span><span class="f_BodyText" style="font-weight: bold;">20</span><span class="f_BodyText"> and </span><span class="f_BodyText" style="font-weight: bold;">120</span><span class="f_BodyText">, so the user sets a value by clicking on arrows in the field to increment or decrement the value within the limits of 20 and 120.</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">The Tagged Values Window</span></p>
<p class="p_BodyText"><span class="f_BodyText">The </span><span class="f_UIControl">Tagged Values</span><span class="f_BodyText"> window is used to view and modify </span><span class="f_BodyText">Tagged Values</span><span class="f_BodyText"> for the currently selected modeling item, either in the current diagram or in the </span><span class="f_UIControl">Project Browser</span><span class="f_BodyText">. </span></p>
<p class="p_BodyText"><span class="f_BodyText">The Tagged Values window is, by default, set to hide fully qualified values (which show exactly where the Tagged Value came from) and duplicate values, as in the first window below. If you prefer, you can change the settings to <a href="showduplicatetags.htm">show duplicate values</a> and fully-qualified values, as in the second window below:</span></p>
<p class="p_TextIndentedL2"><img src="taggedvaluesnote2.png" width="282" height="368" border="0" alt="TaggedValuesNote2"><span class="f_TextIndentedL2"> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <img src="taggedvaluefullyqual.png" width="362" height="355" border="0" alt="TaggedValueFullyQual"></span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="952" bgcolor="#efeff7" style="width:952px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="952" bgcolor="#f7f7ff" style="width:952px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Fully qualified Tagged Values can be displayed only if the Tagged Value was created in Enterprise Architect </span><span class="f_TiporNoteText">release 7.1 or later</span><span class="f_TiporNoteText">. You cannot display the fully qualified path for Tagged Values from earlier releases.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">The </span><span class="f_UIControl">Tagged Values</span><span class="f_BodyText"> window is a dockable window. You can use it to perform the following actions:</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1"><a href="assigningdefinedtaggedvalue.htm">Assign a Tagged Value to an Item</a></span></li>
<li><span class="f_Bulletlist1"><a href="assigningdefinedtaggedvalue.htm#Modify">Modify Tagged Values</a></span></li>
<li><span class="f_Bulletlist1"><a href="assigninginformationtoatag.htm">Assign Notes to a Tagged Value</a>.</span></li>
</ul>
<p class="p_BodyText"><span class="f_BodyText">A Technology Developer can also create new structured Tagged Values, reference data Tagged Values and custom Tagged Values from predefined Tagged Value Types, as described in </span><span class="f_BodyText" style="font-style: italic;"><a href="tagged_value_types.htm">SDK for Enterprise Architect</a>.</span></p>
<p class="p_SubHeadingL1"><a name="modelfeatures"></a><span class="f_SubHeadingL1">Model Elements and Features with Tagged Values</span></p>
<p class="p_BodyText"><span class="f_BodyText">The following model components can use the </span><span class="f_UIControl">Tagged Values</span><span class="f_BodyText"> window as a convenient way to quickly view and modify Tagged Values:</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" bgcolor="#e3e6ed" style="width:120px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Component</span></p>
</td>
<td valign="top" width="577" bgcolor="#e3e6ed" style="width:577px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Description</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" style="width:120px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Elements</span></p>
</td>
<td valign="top" width="577" style="width:577px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Elements display their own Tagged Values along with any inherited values.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" style="width:120px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Object Instances</span></p>
</td>
<td valign="top" width="577" style="width:577px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Object Instances display owned tags and those obtained from their classifier.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" style="width:120px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Ports and Parts</span></p>
</td>
<td valign="top" width="577" style="width:577px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Ports and parts display information similar to objects and display Port/Part 'Type' instead of a classifier. Tags are included for all parents and other structures of the Ports type.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" style="width:120px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Attributes</span></p>
</td>
<td valign="top" width="577" style="width:577px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Include owned Tagged Values and those received from attribute type classifiers, with the inclusion of any inherited ones.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" style="width:120px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Operations</span></p>
</td>
<td valign="top" width="577" style="width:577px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Owned properties only.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="120" style="width:120px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Connectors</span></p>
</td>
<td valign="top" width="577" style="width:577px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Owned properties only.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">When over-riding an inherited property, Enterprise Architect copies the tag from the parent down to the child element and sets the new value, leaving the original tag unchanged.</span></p>
<p class="p_BodyText"><span class="f_BodyText">To edit Tagged Values, use the</span><span class="f_UIControl"> Tagged Values</span><span class="f_BodyText"> toolbar, as described below.</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Tagged Values Toolbar Buttons </span></p>
<p class="p_BodyText"><span class="f_BodyText">The buttons in the </span><span class="f_UIControl">Tagged Values</span><span class="f_BodyText"> toolbar enable you to add, edit, sort, delete and arrange the Tagged Values of model features.</span></p>
<p class="p_TextIndentedL2"><img src="toolbartaggedvalues.png" width="197" height="28" border="0" alt="Toolbartaggedvalues"></p>
<p class="p_BodyText"><span class="f_BodyText">From left to right, the button functions are as follows:</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Compartments</span><span class="f_Bulletlist1"> button displays the Tagged Values in element compartments on diagrams</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Sort Alphabetically</span><span class="f_Bulletlist1"> button sorts the current Tagged Values for the element alphabetically</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">New Tag</span><span class="f_Bulletlist1"> button adds a new tag, to which you assign a value</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Edit Notes</span><span class="f_Bulletlist1"> button enables you to create notes that explain the purpose of the Tagged Value</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Delete selected</span><span class="f_Bulletlist1"> button removes the currently selected Tagged Value</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Default Tagged Value types</span><span class="f_Bulletlist1"> button enables quick access to tag definitions created in the </span><span class="f_MenuKeyField">Configuration</span><span class="f_Bulletlist1"> menu</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Options</span><span class="f_Bulletlist1"> button enables you to show or hide the fully qualified paths for the Tagged Values in the window</span></li>
<li><span class="f_Bulletlist1">The </span><span class="f_MenuKeyField">Help</span><span class="f_Bulletlist1"> button displays help relating to use of the </span><span class="f_UIControl">Tagged Values</span><span class="f_Bulletlist1"> window.</span></li>
</ul>




            </div>
          </div>
        </div>



</div>


</body>
</html>
